home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2001 June / MacHome Magazine Demo Disc June 2001.iso / Stuff / Software / Tools / Clean-Install Assistant 1.5.1 / C-I Assistant Docs next >
Encoding:
Text File  |  2001-02-03  |  10.8 KB  |  121 lines  |  [TEXT/ttxt]

  1. Clean-Install Assistant
  2. ©1998-2001 Marc Moini, all rights reserved
  3. version 1.5.1  2001-02-03
  4. www.marcmoini.com
  5.  
  6. Overview
  7. Upgrading a System Folder to a new version of Mac OS often takes a lot of time, because you need to figure out which files to move to the new system and which ones to leave behind (extensions, control panels, printer drivers, application-specific items, special folders, etc ).
  8.  
  9. Clean-Install Assistant makes this process easier and faster because it does this sorting and moving automatically, using its list of factory-issue Mac OS files. It’ll carefully collect your additions and move them to a separate folder so you can update the System Folder, then it’ll move them back to the right places in the new System Folder with a single click!
  10.  
  11. Supports System 7.x through Mac OS 9.1.
  12.  
  13.  
  14. 1 Collect your additions
  15. To move third-party items and your personal additions out of the selected System Folder, click the Collect button.
  16.  
  17. (Before you start, remember experienced users always backup the System Folder before installing a new one: better spend a few minutes now than waste hours later if anything goes wrong! )
  18.  
  19. A folder named System Folder Additions appears alongside the System Folder, holding all your additions. This should take about 10 seconds (maybe longer on removable media) as no copying takes place, just moving items to a new folder on the same disk.
  20.  
  21. You may want to go through your System Folder at this point to make sure all your additions have been moved. To undo any changes, just click the Add Back button and your System Folder will be restored to its previous state.
  22.  
  23. note: Items in the System suitcase itself are not moved, please move them manually (extra keyboard layouts, sounds)
  24.  
  25. note: While working on the System Folder on the startup disk, it is recommended you startup with Extensions Off (or just the core set) to avoid false alarms from anti-virus or security programs (hold down the shift key until you see the ‘Welcome to Macintosh’ screen at startup). Also, you may want to quit other applications so their preference files are not in use.
  26.  
  27.  
  28. 2 Clean-Install a new System Folder
  29. Use the Mac OS Installer to install a new System Folder.
  30.  
  31.  
  32. 3 Adding all your items to the new System Folder
  33. To move your additions to another System Folder, drag the System Folder Additions folder next to the new System Folder, then select that System Folder in the program and click Add Back. The System Folder Additions folder must be in the same folder as the System Folder you want to Add to: use the Finder to copy the 'System Folder Additions' folder where you want it.
  34.  
  35. When the Add Back button is clicked, any items (file or folders) that already exists in the System Folder are left behind in the System Folder Additions folder. If all the items are moved, the System Folder Additions folder disappears. So if it's still there after Add Back, you know that some items need your attention.
  36.  
  37. note: Duplicate files and other errors will be listed in a log file named CI-A Errors which will appear next to the System Folder. This file only appears when something needs to be reported.
  38.  
  39.  
  40. Some other possible uses:
  41. - Save space and backup your valuable additions and preference files only, instead of the whole System Folder!
  42. - Install the same set of additions on multiple Macs: just copy the ‘System Folder Additions’ folder to each Mac and click ‘Add Back’.
  43. - Remove extra files and folders from your System Folder to restore it to a previous state: you can take a ‘snapshot’ of the System Folder and have Clean-Install Assistant extract any items added since (see below).
  44.  
  45.  
  46. About the ‘List of Mac OS Files’ folder
  47. Clean-Install Assistant treats files and folders as belonging to either of two categories: Items installed by Apple’s Mac OS Installer, and everything else. The List of Mac OS Files  folder holds the list of files and folders which Clean-Install Assistant recognizes as ‘Apple’ items.
  48.  
  49. For those interested, the files in the List of Mac OS Files  folder are standard TEXT files which can be read with any text editor or word processor, and they can be edited if needed. These files can be in any nested folder inside the List of Mac OS Files  folder. Here is the format of a single file:
  50. - each line starts with a number of spaces matching the subfolder level at which it is found in the System Folder.
  51. - lines describing a file have a t: (for type) followed by a four letter file type , a four letter creator code  and the file name.
  52. - lines describing a folder have either fldr:, Afldr: or Sfldr:  in front of the folder name. The A flags ‘Apple’  folders: this decides whether Clean-Install Assistant will move the complete folder or look inside and just move some items, those it doesn’t recognize as ‘Apple’. Here are two examples: the ‘Control Panels’ folder is listed as Afldr, so the program scans it and only moves those control panels which have been added to the standard Mac OS set. By contrast, the ‘KeyQuencer Extensions’ folder (installed by Alessandro Levi Montalcini’s KeyQuencer) would be listed as fldr and the whole folder would be moved. In this example the same results could be achieved just by not including an entry for that folder, but it seems this scheme improves readability in the file/folder list for files generated by users. Sfldr entries describe folders which will be skipped altogether, i.e. never moved. This is used for folders with temporary information, such as the ‘Recent Documents’ folder. When installing the same set of items on multiple Macs, you might not want these items to be copied for confidentiality reasons.
  53.  
  54. To make Clean-Install Assistant generate one of these files for the contents of a System Folder, hold down the option key and the Collect button will change to a List button. This can be useful for generating file lists for localized System Folders. Once your file is saved, you’ll want to edit it (see next paragraph) then move it to the ‘List of Mac OS Files’ folder so Clean-Install Assistant can see it. Don’t worry about duplicate entries in your files, they’re automatically eliminated at runtime.
  55. Also, be sure to include in the name of your file the version number of the System (Mac OS) it refers to. That is, if  the System Folder you listed contains Mac OS 9.1.1, the name of the file should contain 9.1.1. This tells the program to use your file when it processes a System Folder containing 9.1.1. Alternatively, you may omit the number from the title of your file(s) and place it (them) in a folder with 9.1.1 in its name. These version number-tagged file/folders must not be nested inside other folders within the ‘List of Mac OS Files’ folder, they’re only recognized at the top level of that folder.
  56.  
  57. To edit a new file
  58. Once you've clicked List to generate a new file, use a text editor to remove the entries for items you want migrated (files/folders not part of Mac OS), and add an A in front of fldr for folders that you do not want to be moved.
  59. Important: When editing files you’ve created, be sure to remove all entries for preference files that hold important data, such as the Modem Preferences, TCP/IP Preferences  and Remote Access Connections  files which contain your ISP/Online Service information. Otherwise these will be left in the System Folder when you click Collect, and you’ll have to re-enter your preferences from scratch in the new System.
  60.  
  61.  
  62. Free for personal use!
  63. Clean-Install Assistant is free for personal and educational use. Pricing for business users is as follows (for more details please see the ‘for business users’ folder):
  64.  • Businesses with 3 Macs or less: Free
  65.  • Consultants and businesses with 4 to 10 Macs: $50
  66.  • Site License (all Macs within a 100 miles radius of your site): $500
  67.  • World-Wide License (all locations for your organization): $1000
  68.  
  69. Please distribute Clean-Install Assistant as a complete package, with this document, the Startup Doubler and Smart Scroll movies, the List of Mac OS Files folder and the ‘for business users’ folder. It is OK to upload the unmodified package to BBSs, the Internet and online services, and to put it on a CD-ROM.
  70.  
  71. If you like this program, take a look at the other programs by the same author! (see below)
  72.  
  73.  
  74. Acknowledgments
  75. Many thanks to Alessandro Levi Montalcini, FlM, Vils Legrand, Marc Menschenfreund, Mark Nagata and Charles Wiltgen!
  76.  
  77. Julien Erny (julien@kagi.com) created the sound tracks for the QuickTime movies.
  78.  
  79.  
  80. Disclaimer
  81. The author makes no warranties, either express or implied, regarding the fitness of Clean-Install Assistant for any particular purpose. Use Clean-Install Assistant at your own risk. The author claims no liability for data loss or any other problems caused directly or indirectly by Clean-Install Assistant.
  82.  
  83.  
  84. Other programs by the author
  85. Startup Doubler makes for quicker startups! Its software acceleration compensates for sub-optimal disk performance to make extensions and control panels load faster, reducing startup time 20 to 50 percent on older Macs and 10 to 20 seconds on the lastest G3s and G4s! Download it from www.marcmoini.com
  86.  
  87. Smart Scroll enhances scrollbars with the following features:
  88. Scrolling Speed control: adjust it for all situations and all Mac models. If your G3 or G4 Mac scrolls too fast, this is the cure!
  89. Proportional Thumbs: The size of the thumb relative to the scrollbar shows how much of a document is displayed in a window! Mac OS 8 & 9 mostly enhance the Finder's scrollbars, but Smart Scroll brings this feature to other apps, including Netscape, Emailer, Eudora, ClarisWorks...
  90. Live Scrolling updates the display as you drag the scrollbar thumb. Hard to believe you managed without once you try it! www.marcmoini.com
  91.  
  92. Custom/TearOff Menus  lets you tear-off any menu and float it above the desktop for quick and easy access at any time (this is a feature Apple reportedly plans for Mac OS X, but you can have it now!). Build your own menus from items in any menu. Rename any item ! Choose your own Font, Size and colors for the menus and the menu bar. Pop-Up the menu bar under the mouse : fast access to menus with less mouse travel! For system 7.x to 8.1 only. Download from www.marcmoini.com
  93.  
  94.  
  95. Version History
  96. Download the latest version from www.marcmoini.com or an Info-Mac mirror or the MIT HyperArchive at http://hyperarchive.lcs.mit.edu/HyperArchive.html.
  97.  
  98. 1.5.1 (2001-02-03)
  99. • Supports Mac OS 9.1
  100. • Misc. changes and fixes
  101.  
  102. 1.5 (2000-09-12)
  103. • Supports Mac OS 9.0.4
  104. • Is now able to recognize the version number of the System Folder it is working on, to recognize Apple files from other versions as additions.
  105. • Misc. changes and fixes
  106.  
  107. 1.2 (1999-10-23)
  108. • Supports Mac OS 9.0.
  109. • Supports Mac OS 8.6.
  110. • Misc. changes and fixes.
  111.  
  112. 1.1 (1998-10-23)
  113. • Supports Mac OS 8.5.
  114. • Collects items from previous System Folders as well as current (active) ones
  115. • New folder label in file lists: ‘Sfldr’ entries are not moved (thanks, Wayne W. Smerdon!)
  116. • Now saves ‘CD Remote Programs’ settings (thanks, James R. Cain!)
  117. • Misc. changes and fixes.
  118.  
  119. 1.0 (1998-05-18)
  120. • First public release
  121.